:target{#bullet-lists}

# Bullet Lists

- A bullet list
  - Nested bullet list.
  - Nested item 2.
- Item 2.

  Paragraph 2 of item 2.
  - Nested bullet list.
  - Nested item 2.
    - Third level.
    - Item 2.
  - Nested item 3.

:target{#enumerated-lists}

# Enumerated Lists

1. Arabic numerals.
   1. lower alpha)
      1. (lower roman)
         1. upper alpha.
            1. upper roman)
2. Lists that don't start at 1:
   3. Three
   4. Four
   3) C
   4) D
   3. iii
   4. iv
3. List items may also be auto-enumerated.

:target{#definition-lists}

# Definition Lists

<DefinitionList>
  <dl>
    <dt>
      <DefinitionList.Term><span>Term</span></DefinitionList.Term>
    </dt>

    <dd>
      Definition
    </dd>

    <dt>
      <DefinitionList.Term><span>Term</span></DefinitionList.Term><em className="classifier"> : classifier</em>
    </dt>

    <dd>
      Definition paragraph 1.

      Definition paragraph 2.
    </dd>

    <dt>
      <DefinitionList.Term><span>Term</span></DefinitionList.Term>
    </dt>

    <dd>
      Definition
    </dd>
  </dl>
</DefinitionList>

:target{#field-lists}

# Field Lists

<FieldList>
  <dl>
    <dt className="field-name">
      what
    </dt>

    <dd className="field-body">
      Field lists map field names to field bodies, like database
      records.  They are often part of an extension syntax.  They are
      an unambiguous variant of RFC 2822 fields.
    </dd>

    <dt className="field-name">
      how arg1 arg2
    </dt>

    <dd className="field-body">
      The field marker is a colon, the field name, and a colon.

      The field body may contain one or more body elements, indented
      relative to the field marker.
    </dd>
  </dl>
</FieldList>

:target{#option-lists}

# Option Lists

For listing command-line options:

<OptionList>
  <dl>
    <dt>
      <span className="option"><span>-a</span></span>
    </dt>

    <dd>
      command-line option "a"
    </dd>

    <dt>
      <span className="option"><span>-b</span><span className="argument"> file</span></span>
    </dt>

    <dd>
      options can have arguments
      and long descriptions
    </dd>

    <dt>
      <span className="option"><span>--long</span></span>
    </dt>

    <dd>
      options can be long also
    </dd>

    <dt>
      <span className="option"><span>--input</span><span className="argument">=file</span></span>
    </dt>

    <dd>
      long options can also have
      arguments
    </dd>

    <dt>
      <span className="option"><span>--very-long-option</span></span>
    </dt>

    <dd>
      The description can also start on the next line.

      The description may contain multiple body elements,
      regardless of where it starts.
    </dd>

    <dt>
      <span className="option"><span>-x</span></span>, <span className="option"><span>-y</span></span>, <span className="option"><span>-z</span></span>
    </dt>

    <dd>
      Multiple options are an "option group".
    </dd>

    <dt>
      <span className="option"><span>-v</span></span>, <span className="option"><span>--verbose</span></span>
    </dt>

    <dd>
      Commonly-seen: short & long options.
    </dd>

    <dt>
      <span className="option"><span>-1</span><span className="argument"> file</span></span>, <span className="option"><span>--one</span><span className="argument">=file</span></span>, <span className="option"><span>--two</span><span className="argument"> file</span></span>
    </dt>

    <dd>
      Multiple options with arguments.
    </dd>

    <dt>
      <span className="option"><span>/V</span></span>
    </dt>

    <dd>
      DOS/VMS-style options too
    </dd>
  </dl>
</OptionList>

There must be at least two spaces between the option and the
description.
